home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / strqget.z / strqget
Encoding:
Text File  |  1998-10-30  |  4.6 KB  |  132 lines
  1.  
  2.  
  3.  
  4. ssssttttrrrrqqqqggggeeeetttt((((DDDD3333))))                                                        ssssttttrrrrqqqqggggeeeetttt((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_tttt_rrrr_qqqq_gggg_eeee_tttt - get information about a queue or band of the queue
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_tttt_rrrr_eeee_aaaa_mmmm_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  15.      _iiii_nnnn_tttt _ssss_tttt_rrrr_qqqq_gggg_eeee_tttt_((((_qqqq_uuuu_eeee_uuuu_eeee______tttt _****_q_,,,, _qqqq_ffff_iiii_eeee_llll_dddd_ssss______tttt _w_h_a_t_,,,, _uuuu_cccc_hhhh_aaaa_rrrr______tttt _p_r_i_,,,, _llll_oooo_nnnn_gggg _****_v_a_l_p_))))_;;;;
  16.  
  17.    AAAArrrrgggguuuummmmeeeennnnttttssss
  18.      _q         Pointer to the queue.
  19.  
  20.      _w_h_a_t      The field of the queue about which to return information.
  21.  
  22.      _p_r_i       Priority band of the queue about which to obtain information.
  23.  
  24.      _v_a_l_p      Pointer to the memory location where the value is to be stored.
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      _ssss_tttt_rrrr_qqqq_gggg_eeee_tttt gives drivers and modules a way to get information about a queue
  28.      or a particular priority band of a queue without directly accessing
  29.      STREAMS data structures.
  30.  
  31.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  32.      On success, _0000 is returned.  An error number is returned on failure.  The
  33.      actual value of the requested field is returned through the reference
  34.      parameter, _v_a_l_p.
  35.  
  36. UUUUSSSSAAAAGGGGEEEE
  37.      Valid _w_h_a_t values are:
  38.  
  39.           _QQQQ_HHHH_IIII_WWWW_AAAA_TTTT    High water mark of the specified priority band.
  40.  
  41.           _QQQQ_LLLL_OOOO_WWWW_AAAA_TTTT    Low water mark of the specified priority band.
  42.  
  43.           _QQQQ_MMMM_AAAA_XXXX_PPPP_SSSS_ZZZZ   Maximum packet size of the specified priority band.
  44.  
  45.           _QQQQ_MMMM_IIII_NNNN_PPPP_SSSS_ZZZZ   Minimum packet size of the specified priority band.
  46.  
  47.           _QQQQ_CCCC_OOOO_UUUU_NNNN_TTTT    Number of bytes of data in messages in the specified
  48.                     priority band.
  49.  
  50.           _QQQQ_FFFF_IIII_RRRR_SSSS_TTTT    Pointer to the first message in the specified priority
  51.                     band.
  52.  
  53.           _QQQQ_LLLL_AAAA_SSSS_TTTT     Pointer to the last message in the specified priority
  54.                     band.
  55.  
  56.           _QQQQ_FFFF_LLLL_AAAA_GGGG     Flags for the specified priority band [see _qqqq_uuuu_eeee_uuuu_eeee(D4)].
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. ssssttttrrrrqqqqggggeeeetttt((((DDDD3333))))                                                        ssssttttrrrrqqqqggggeeeetttt((((DDDD3333))))
  70.  
  71.  
  72.  
  73.    LLLLeeeevvvveeeellll
  74.      Base or Interrupt.
  75.  
  76.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  77.      Does not sleep.
  78.  
  79.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  80.      across calls to this function.
  81.  
  82. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  83.      _qqqq_uuuu_eeee_uuuu_eeee(D4), _ssss_tttt_rrrr_qqqq_ssss_eeee_tttt(D3),
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.